package simonby.top.annualring.domain.repository;

import simonby.top.annualring.domain.model.User;
import java.util.List;
import java.util.Optional;

/**
 * 用户仓储接口
 * 定义用户相关的数据访问操作
 */
public interface UserRepository {
    /**
     * 保存用户
     * @param user 用户实体
     * @return 保存后的用户
     */
    User save(User user);

    /**
     * 根据ID查找用户
     * @param id 用户ID
     * @return 用户对象
     */
    Optional<User> findById(Long id);

    /**
     * 根据用户名查找用户
     * @param username 用户名
     * @return 用户对象
     */
    Optional<User> findByUsername(String username);

    /**
     * 查找所有用户
     * @return 用户列表
     */
    List<User> findAll();

    /**
     * 删除用户
     * @param id 用户ID
     */
    void deleteById(Long id);

    /**
     * 根据邮箱查找用户
     * @param email 邮箱
     * @return 用户对象
     */
    Optional<User> findByEmail(String email);
}